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The principle and operation of a utility program for the PDP 1 
computer are described. The program is an aid in the editing or modi- 
fication of alphanumeric text in that the operator may communicate 
with the computer in the very alphanumeric s of the text itself. It is a 
computer time-saver in that the modifications and the control instruc- 
tions for their accomplishments may be prepared at an inexpensive, 
off-line machine. 
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TED: A Tape Editor 


INTRODUCTION:. 

* s the OAL program for preparing and editing symbolic 
tapes with the aid of the PDP-1 computer. With TED all typing invol- 
ved in preparing and editing tapes may be done at an off-line typewrite 
punch. Thus, TED permits off-line editing in the sense that all typing 
may be done off-line and the only on-line time required is that necess- 
ajry for the reading of text and control tapes. 

EDITING FEATURES: 

With TED tapes are edited by killing a line or block of lines, 
inserting a line or block of lines, and substituting one line for another 
line. Memory may be inspected by requesting one or more lines to be 
typed or displayed on the scope. A line may be referred to by its 
symbolic address. This is true for the typing, displaying, reading, 
punching, killing, inserting, and substituting of lines. 

TED has a text mode and a control mode; a mode change 
occurs when an overstrike is typed in or read in. When TED is in 
text mode, characters are stored in the temporary text buffer until a 
carriage return occurs. The carriage return resets the temporary 
text buffer and adds the line to the permanent buffer. 

In control mode characters are stored in a temporary control 
buffer. A carriage return resets the control buffer and causes the 
control statement to be executed. Control statements are not stored 
in a permanent buffer. 

The backspace operates in both modes to kill the last 



character. In control mode it operates on the temporary control 
buffer; in text mode it operates on the temporary text buffer. When in 
control mode, the typewriter types in black. Thus, the typewriter is 
in red only when characters are being stored in a text buffer. TED 
starts in control mode, black and lower case. 


CONTROL CHARACTERS: 

Control statements in TED begin with a control character that 
denotes the operation to be performed, and operates upon one or more 
lines of the permanent text buffer. The control characters and their 
general meaning are listed below. 


Character 

t 

. (period) 

, (comma) 
d 

P 

r 

k 

(middle dot) 
/ ( slash) 
i 
s 
1 


Meaning 

type 


display 

punch 

iread 

kill 


jnsert (after) 

^substitute 

leader 


Listed below are the eight control statements which consist 
only of a control character. Carriage return is indicated by^ . 



S ingle Gharacte 
Statement 

U 

,j( period) 

■J 

V 

[i 

^(middle dot) 

V 


Statements 

Meaning 
types all lines 
type s last line 
types first two lines 
punches all lines 
reads all lines 
kills all lines 
kills last line 
punches leader 


CONTROL STATEMENTS WITH SYMBOLIC ADLRESSES: 


All control characters which are letters (except 1) may be 
used with symbolic addresses; the others may not. In TED a symbolic 
address is the string of characters from the carriage return to the 
tab. For DECAL symbolics, block symbols, program symbols, and 
system symbols would normally be symbolic addresses for T^D. In 
the following examples, the symbolic addresses are block symbols 
in the DECAL system. For TED a symbolic address may not contain 
spaces or begin with a period. A control statement with one symbolic 
address is simply the control character followed by the symbolic 
address. An example is the H type" statement: 

tstart: j 

which will result in the line with the symbolic address start, being 
typed. This example is appropriate for the control characters p, d, 
and k. The control characters r, i, and s require some additional 
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explanation. The control statement 

rstart : j 

will result in the tape being read up to and including the line with the 
symbolic address _start^ • The control statement 

istart : ^ 

will result in the last line of permanent text buffer being inserted after 
the line with the symbolic address start: . The control statement 

s start : j 

will result in the last line of permanent text buffer being substituted 
for the line with the symbolic address start: . This statement is 


equivalent to 


istart: j 
k start: J 

A line which does not have a symbolic address may be 
referenced by indicating the number of lines it is below a line with a 
symbolic address. Any line with a symbolic address may be chosen. 
The control statement 


tstart:/5y 

will result in the fifth line after start: being typed. The count is in 
octal and should not exceed octal 77. The slash is used here rather 

than plus to avoid case shifts. 

The control characters t, d, p, k, and i may be used with 
two symbolic addresses. The format is the control character, the 
first symbolic address, a comma, the second symbolic address. The 
"type" example 


t start:, finish : j 
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is appropriate for d, p, and k. The first symbolic address indicates 
the first line of a block; the second symbolic address indicates the last 
line of a block. Thus, the example would result in the block of lines 
beginning with start: and ending with finish: being typed. 

The insert statement has a different meaning. The control 
statement 


i start:, finish:^) 


would result in the block of lines beginning with fini gill and ending with 
the last line of permanent text buffer being inserted after starf; . 


SPECIAL FEATURES: 

Whenever TED reads from tape a control statement it cannot 
execute, it does one of two things. (1) If the statement begins with a 
legitimate control character the reader stops, the unexecutable state- 
ment is typed, control is turned over to the typewriter, and TED goes 
to control mode. Thus, the correct control statement may be typed. 

(2) If the control statement does not begin with a legitimate control 
character it is ignored. Unexecutable control statements (beginning 
with a legitimate control character) which are type a in result in "error 
being typed back. Unexecutable statements generally occur because 
a symbolic address was incorrectly typed. 

If TED's permanent text buffer is filled, "buffer full" will be 
typed out in red. If this occurs while TED is trying to satisfy a read 
statement, the reader will stop, control will be turned over to the 
typewriter, and TED will go to control mode. 

If sense switch 5 is up when the buffer is filled, TED will 
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punch and kill the first seven lines an'd continue reading, repeating 
this until She whole tape has been read. Thus, TED will read a tape 
of any length. However, control statements should not refer to lines 
which have been read more than two or three pages earlier since this 
much ordinary symbolic program material is about the capacity of the 
permanent text buffer. 

TED assumes that a tape begins in text mode. Thus, if a tape 
is tc begin with a control statement, the tape should begin with an 
overstrike. When TED finishes reading a tape, it always turns control 
over to the typewriter and goes to control mode. 

A display resulting from a statement which is typed will be 
terminated by the striking of any key except space bar. Striking the 
space bar will cause the block being displayed to be indexed. Thus, if/' 
lines three through five are displayed before the space bar is struck, 
lines four through six will be displayed after the space bar is struck. 

In this manner, the display may be stepped through an entire program. 

If a display statement is read from tape, the display will be 
modified by the space bar as described above. A carriage return will 
cause the display to terminate and TED to continue reading tape. 

Typing a left paren will turn control over to the typewriter and TED 
will be in control mode. All other keys are ignored. 

TED displays both lowercase and uppercase characters. 

Thus, a block of lines which is displayed will look just as it would if 
they were typed. The only qualification is that the display feature 
has only two fixed tabs. 
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SUGGESTIONS AND CAUTIONS: 

In the following, I I indicates uppercase, indicates lower- 
case, and ^indicates tab. So that the first line of a symbolic tape 
will always have a label, it is suggested that the first line be: 

If this is- done, there will never be a line in a symbolic tape that 
cannot be referenced by a label, since control statements of the form 


IT \\j' 


are permissable. This procedure will not affect the compilation with 
DECAL. 


In order that material typed off-line will look as if it had been 
typed on-line, change ribbon color after the overstrike is struck. 

Tapes should start in red. 

If several lines have identical symbolic addresses, TED 
assumes that a control statement with such a label refers to the first 
one. 

If tapes are to be compiled with DECAL, one may tab after 
dss or fin. , making these symbolic addresses for TED. 

Before returning the carriage or tabbing, the typewriter 
should always be in lowercase. If this is not done, TED may not 
recognize symbolic addresses and displayed lines may be in the wrong 
case. 

TEI) will readleader and trailer consisting of feed holes or "7" 
holes. Errors made by the operator of the off-line typewriter-punch 
should be corrected by backspaces and never by "delete" punches. 


- 7 - 



APPENDIX 


EXAMPLES OF EDITING WITH TED 

The following subroutine, in symbolic form, with hand-noted 
changes could be edited in a variety of specific ways. Two examples 
are given. 


dss 
ass cr 

dss prmd black wait 
dss temp cntrl os 


hold mdck ipt 



t: 

a: 










fin. 


dac hold 
jmp mdck 
szf' 4 
jmp rpt 
elf 4 
dzm ipt 
lac prmd 
sad black 
jmp wait 
lac cr 
dac temp 
law' 2 
dac cntrl 
lac o s 
jmp t 




The original symbolic tape is first read into TED by striking 
r . The control tape below is then read the same way. 
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Off-line control tape: 


Function: 


jrpt' 

irpt 1 

krpt'/l, rpt'/5 
Orpt*' 

dss check 
itlss 


rpa' 


jsp check 


ddss, a: / 1 5 


1 

P 

1 

/ 


Text to be substituted 

Control instruction to execute same 

Removes lines "cli" through "spi" 

Line to be added after "rpt" 

Inserts above line after "rpt" 

New dss line to be added 
Inserts above after first dss, which has 
been made a "symbolic address" here 
Will cause display of entire edited text 
At this point striking a carriage return 
would cause the program to continue 
reading the control tape. Striking the 
( would return control to the operator. 
Will make 500 lines of feed holes for 
leader 

Will punch off entire edited text 
Will make trailer, as above 
Will kill entire text, preparatory for 
next editing job. 


Example 2: 

Off-line control tape: Function: 


dss check 
rpt' 

irpt' / 5, fin. /I 


rpa' 

jsp check 


krpt' /rpt' / 5 

1 

P 

1 


Text to be inserted 


Will insert all three of the lines in 
red'(these having been added to the 
permanent text following fin. which 
here has been made a symbolic add- 
ress by a tab after the period). 

Will kill the six lines at the top 
beginning with rpt 1 

Leader, punchoff and trailer as before 


Note: The extra carriage returns in the above examples are not 
needed in the actual control tape. 
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